Windows Codex安装指南

官方原版安装

系统要求：Windows 10 (版本 1809 / build 17763) 及以上

执行前准备

先按下面 3 步安装 Git 和 Node.js，再继续执行后面的 Codex 配置流程。

1

【此步骤在桌面】下载 Git

访问 https://git-scm.com/downloads/win，安装时全部下一步，不要修改路径。
2

【此步骤在桌面】下载 Node.js

访问 https://nodejs.org/zh-cn/download，安装时全部下一步，不要修改路径。
3
【此步骤在 Windows PowerShell】验证安装情况

打开 Windows PowerShell（蓝色图标），执行以下命令验证安装情况：
```
PS> node -v
PS> npm -v
```

若提示 No suitable shell found，说明 Git 没装好。请将 CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\git\bin\bash.exe 设置到系统环境变量中，重启终端后再试；如果仍然无效，重装 Git，重启终端后再试。

安装步骤

安装 Codex 官方原版包

$ npm install -g @openai/codex
# 或者
$ brew install codex

2

创建目录

先删除 C:\users\你的用户名\.codex（若有），然后再重新创建 C:\users\你的用户名\.codex
3

在「API密钥」界面配置一个API KEY

访问仪表板的「API密钥」页面，创建并复制一个新的 API密钥
4
创建auth.json文件

删除 C:\users\你的用户名\.codex 路径下已存在的 auth.json 文件(若有)，然后新建一个 auth.json，内容为：
```
{
  "OPENAI_API_KEY": "你的API_KEY"
}
```

创建config.toml文件

删除 C:\users\你的用户名\.codex 路径下已存在的 config.toml 文件(若有)，然后新建一个 config.toml，内容直接原封不动的粘贴下文：

model_provider = "flu"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.flu]
name = "flu"
base_url = "https://www.fluapi.com/v1"
wire_api = "responses"

重启终端，验证安装结果

重启终端后运行以下命令，确认安装成功
```
$ codex -v
```

开始使用

安装完成后，您可以在任何项目目录中开始使用 Codex：

# 导航到您的项目
$ cd your-project-folder

# 启动 Codex
$ codex

支持VSCode官方插件

完全支持VSCode官方插件